home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / clang / tcomm50.zip / READ.ME < prev    next >
Text File  |  1989-08-01  |  5KB  |  132 lines
  1. -  Notes for Revision 5.0
  2.  
  3. If you have just acquired the shareware version of the LiteComm(tm)
  4. Toolbox, try the QBTTL sample program and look over its code, feel free
  5. to experiment with the functions and, if you like what you see, please
  6. register and join our list of satisfied users from all over the world.
  7.  
  8. If you've registered LiteComm, thank you.  Your registration helps make 
  9. it possible for us to continue supporting and enhancing the product.
  10.  
  11. REGISTERED USERS PLEASE NOTE:
  12. The serial number of your copy is found on the diskette label, not in 
  13. the lserial.num file as mentioned in the documentation.
  14.  
  15. With Revision 5.0, the most critical portion of the kernel, we have 
  16. further reduced the code in the interrupt handler which not only reduced 
  17. the size of this critical section, but allowed further savings in other 
  18. areas.  See the documentation section "New in Version 4.0" for
  19. additional details.
  20.  
  21. NOTE CAREFUULY!!!
  22. If you have used LiteComm before, it will be necessry for you to
  23. re-compile and relink your applications, primarily do to changes that
  24. we instituted in the Communications Control Block (CCB).
  25.  
  26. You should not have to modify the any of the source code to compile it 
  27. on any of the supported compilers.  Extensive use of C preprocessor 
  28. statments has been made to insure that all modules will compile under 
  29. any of the supported compilers with no additional effort.
  30.  
  31. With version 5.0, we have dropped the library-only registration class, 
  32. largely due to the fact that more than 97 per cent of all registrants 
  33. obtain the source code.  All library-only registrants will be 
  34. automatically eligible for a no-charge upgrade to the full source 
  35. version on payment of the $10 upgrade fee which all registrants must 
  36. pay to upgrade to the latest version of LiteComm.
  37.  
  38. We have also provided a complete set of "make" files to assist you in
  39. rebuilding the libraries, should it become necessary, or should you
  40. wish to modify the supplied routines.  Be cautious...the make files, at
  41. a minimum, assume that you have both ARC and LIB available in either
  42. your current working directory or somewhere in the current path.  Note
  43. also that you MUST have available either MASM 5.X or Turbo Assembler
  44. version 1.0 or greater.
  45.  
  46. LiteComm is an advanced product for advanced users.  Due to the various 
  47. conditions under which LiteComm might be used, we have not attempted to 
  48. provide you with specific instructions on linking the LiteComm libraries 
  49. with your application programs.  We assume that you are familiar with 
  50. the methods needed to link third-party libraries, such as LiteComm, with 
  51. your applications.  Answering specific questions regarding linking of 
  52. LiteComm to any given application is not practical, since it requires 
  53. specific knowledge of how your system is organized, and of your 
  54. application that cannot generally be obtained by telephone.
  55.  
  56. DOCUMENTATION CHANGES
  57. ---------------------
  58.  
  59. In the process of developing the documentation for the new 
  60. BBS(so-called) functions a few pieces of information were inadvertantly 
  61. omitted.  We provide this additional information below as an assist to 
  62. your use of the new functions.
  63.  
  64. Note that to use the lcbbs functions, you must include as a part of 
  65. your link the xmodem library, since the lcbbs functions use one of that 
  66. library's component function to purge the receive buffer.  The purge 
  67. function is a 1 second, timed wait for input that returns when 1 second 
  68. has elapsed with no input received during that period.  Any input that 
  69. is received is discarded.  In addition, it will be necessary for you to 
  70. use the lc_insclock function (see the documentation) to properly install 
  71. a clock handler.  If you do not install a clock handler, the purge 
  72. function will either behave erratically or will, at worst, cause your 
  73. system to hang.  Alternatively, if you wish, you may write your own 
  74. purge function using the event timers included in the new functions.  
  75. For shareware users, this will be mandatory, since we do not intend to 
  76. alter our distribution policy.  As an aid, we have include a sample 
  77. purge function below that you might want to use.
  78.  
  79. /*
  80. ** sample purge function
  81. */
  82. #include "litecomm.h"
  83. #include "lcbbs.h"
  84.  
  85. void purge(port)
  86. {
  87.     long purge_ev;
  88.  
  89.     purge_ev = new_event(1);        /* 1 second timer */
  90.     while (1)
  91.     {
  92.         if (lc_get(port) == -1)        /* got a character? */
  93.             if (! check_event(purge_ev)) /* ZERO if expired */
  94.                 return;
  95.             else
  96.                 continue;            /* timer did not expire */
  97. /*
  98. ** we got a character, reset the timer so
  99. ** that there is another 1 second timeout
  100. */
  101.         purge_ev = new_event(1);        /* 1 second timer */i
  102.     }
  103. }        
  104.  
  105.  
  106. /*
  107. ** These are sample strings to be sent for
  108. ** modem initialization.  They must be customized
  109. ** to suit the inividual modem
  110.  
  111. char MODEMSET0[] = "ATZ\r";
  112. char MODEMSET1[] = "ATT E0\r";
  113. char MODEMSET2[] = "ATC1 V0 X1 S0=1 M1\r";
  114.  
  115. ** corresponds to
  116. **    Reset
  117. **    Touch Tone Dialing, Command Echo off *
  118. **    Carrier off/detect carrier
  119. **    Numeric codes *
  120. **    Hayes extended set
  121. **    answer on first ring
  122. **     enable the speaker
  123. **
  124. ** starred items are needed at a minimum
  125. */
  126.  
  127.  
  128. Information Technology
  129.  
  130. LiteComm is a trademark of Information Technology.
  131. Microsoft is a registered trademark of Microsoft Corp.
  132.